Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / ppe25b.arc / BATDOC.BAT < prev next >

Wrap

DOS Batch File | 1986-07-14 | 19.6 KB | 471 lines

bat /p * Loading HELP and DOCUMENTATION ..... (Non-IBM systems, read NOTE below) * Written by F.Canova 10/5/83 through 07/7/86 * (c) Copyright 1983, 1985, 1986 by Seaware Corp. all rights reserved. * This batch file REQUIRES EBL Version 3 for proper execution! **** NOTE! NOTE! NOTE! NOTE! **** RAM |* <-----Change 'RAM' to 'BIOS' if PC isn't 100% IBM Compatible! if %G = .goto. then %G = | goto -%F else goto -line0 -header * Routine prints general purpose header for help text stack.purge |* remove any pre-typed keystrokes. %n = %i $ 1 ( %i # - 2 ) & . & ( %i $ ( %i # - 1 ) 2 ) |* extract section # from page # cls begtype \17╔══════════════════════════════════════════════════════════════════════════════╗\1F \%H Page \%n \17 ╚══════════════════════════════════════════════════════════════════════════════╝\07 Press: PGDN for next page, PGUP for prev page, HOME for main menu. end return -scroll * Routine accepts key for scrolling help text %e = 0 inkey %k if %k = KEY003 goto -opt0 |* Break key if %k = KEY01B %i = 0 | goto -line0 |* ESC key if %k = KEY147 %i = 0 | goto -line0 |* Home key if %k = KEY149 %i = %i - 1 | cls | %F = line%i | goto -%F |* PgUp key if %k = KEY151 %i = %i + 1 | cls | %F = line%i | goto -%F |* PgDn key goto -scroll |* ignore any other key. -line1405 -line099 -line0 %e = 0 cls begtype \1F╔════════════════ BATDOC ═══════════════════╗\07 \17┌─────────────────────────┐\07 \1F║ Menu driven HELP and DOCUMENTATION. ║\07 \17│ User supported software │\07 \1F╙───────────────────────────────────────────╜\07 \17│ by │\07 \17│ │\07 \4fGENERAL:\07 \17│ Seaware Corp. │\07 1. Introduction and how to use this Help. \17│ P.O. Box 1656 │\07 2. The user supported concept. \17│ Delray Beach, FL 33444 │\07 3. BAT-BBS information. On-line users forum. \17│ 305/276-5072 │\07 4. What EBL is... an introduction! \17│ │\07 5. Version 3: The inside story! \17│ Order your registered │\07 \17│ copy for $49 from us │\07 \4fEXTENDED BATCH LANGUAGE Version 3\07 \17│ directly or our order │\07 6. Printing to display. \17│ line at 800/622-4070 │\07 7. Reading data from users. \17│ or 800/942-7317 in IL. │\07 8. Controlling program flow \17│ │\07 9. Using the keyboard stack. \17│ Please copy and share │\07 10. Sensing program's results. \17│ BAT.COM, BATFUNC1.COM, │\07 11. Assignment statements. \17│ BATDOC.BAT, BATDEMO.BAT │\07 12. Debugging aids. \17│ for non-commercial uses │\07 13. Extended functions. \17│ only. │\07 14. Additional information. \17└─────────────────────────┘\07 0. Exit. END -entry0 %o = read Enter the number of your selection. > %A if / = /%a %a = 1 if %a < 15 if %a > 1/ cls %F = opt%a | goto -%F if %a < : if %a > / cls %F = opt%a | goto -%F beep begtype I DON'T KNOW THAT OPTION! Just enter a number 0 to 14 and press the ─┘ key. end goto -entry0 -opt0 cls begtype Ready to leave on-line help! Press a key: <\0FS\07>ystem <\0FD\07>emo <\0FH\07>elp end -exiting inkey %a if %a = S exit if %a = H goto -line0 if %a = D stack BATDEMO | exit beep goto -exiting -line100 -opt1 %h = INTRODUCTION | %i = 100 | call -header begtype This program will provide you with help information on the use of the EXTENDED BATCH LANGUAGE version 3.0. It is designed to allow for easy access and retrieval of information that would be harder to find by more conventional means. The information is broken up into multiple sections. Each section may have several pages. To access each page in order, just keep pressing the PGDN key. At the top of your screen is the name of the section which you are in and the page number. \0FNote:\07 If you wish to directly enter another section now, press the \0fHOME\07 key to return to the main menu, enter the proper \0fsection number\07 and press the \0f─┘\07 key. end goto -scroll -line101 call -header | begtype While in any of these sections, there are just three keys needed: PGDN - This key will advance to the next page of any section. If there are no more pages in the section, then it will advance to the next section. PGUP - This key will back up to a previous page within a section. If there are no more previous pages within a section, it will backup to the previous section. HOME or ESC - Either of these keys will return directly to the main menu. From the menu, any section can be looked at directly by entering the section number and pressing ─┘. end goto -scroll -line199 %i = 102 -line102 call -header | begtype There are several sections where you will be given questions and answers. If you would like to peek and see answer without specifically answering it, you can press the space bar to reveal the answer letter by letter. One interesting facet you should know while using this on-line help and documentation is that you are using the EXTENDED BATCH LANGUAGE program to display and control these menus. Never before has a batch language been so powerful on the IBM personal computer as to be able to provide a facility like this. In the following pages of description, we hope that you will see, as we did, that this program has extraordinary capability which does much more than just expand the capability of DOS. In fact, it gives new power to your system by providing capabilities never before possible. end goto -scroll -opt2 -line103 %i = 200 -line200 %H = "User Supported Concept" | call -header | begtype ╓─ ─╖ ║ The license fee for Extended Batch Language is $49. ║ ║ ║ ║ You are encouraged to copy and share BAT.COM, BATFUNC1.COM, BATDOC.BAT ║ ║ and BATDEMO.BAT for non-commercial purposes only. You must not modify ║ ║ any of these files or make a profit from their distribution. ║ ║ ║ ║ In appreciation of your support, you will be provided with many more ║ ║ powerful extensions to the language (including source code), examples, ║ ║ and detailed documentation. All registered users can also access the ║ ║ BAT-BBS, a hot-line for assistance, tips, and updates. ║ ║ ║ ╙─ (c) Copyright 1982, 1983, 1984, 1986 by Seaware Corp. ─╜ All rights reserved. Seaware Corp. 305/276-5072 Post Office Box 1656 800/622-4070 Delray Beach, FL 33444 (800/942-7317 in Illinois) end goto -scroll -line299 %i = 201 -line201 call -header | begtype For $49, you will be provided with a detailed users guide. This hardcopy manual has almost 400 pages of descriptions, examples, useful utilities, and tips on this program's use. You will also receive a diskette containing the latest program version and useful utilities. All users are also invited to use the BAT-BBS, an on-line forum for user's ideas, tips, programs, and assistance. (See next section for more information). Our users have signed on thousands of times and testified that this service has helped make Extended Batch Language one of their best supported programs on their system. The concept of excellent user support is buried deep in our roots. Much of our philosophy was founded by Andrew Fugleman at Headlands Press, Inc. I would like to thank Andrew for his inspiration and help. Because I feel that good software should have someone standing behind it, we at Seaware want to put your patronage directly into support for you as our thanks of your support of us. You will find it well worth it. Seaware Corp. ≡≡≡≡ Post Office Box 1656 ≡≡≡≡ Delray Beach, FL 33444 end goto -scroll -opt3 -line202 %i = 300 -line300 %H = "BAT - BBS" | call -header | begtype \0eProvided to registered users only:\07 One of the special services we provide to EXTENDED BATCH LANGUAGE users is through a communication medium called "BAT-BBS". This is a direct link from you to other users, as well as Seaware. The following list shows the many things that BAT-BBS can provide . . . end goto -scroll -line301 call -header | begtype FOR USERS WITH A MODEM: * Receive program updates as soon as they are available! * BAT-BBS is a hotline for your questions! * Directly access our computer at Seaware via phone. * It will be ready to give helpful ideas. * Programs and Utilities are available to download. * Users are welcome to upload their programs/ideas. * Tips and techniques are on-line. * Converse with other users and program author via electronic mail. end goto -scroll -line302 call -header | begtype IF YOU DON'T HAVE A MODEM: * You can still phone the BAT-BBS if you wish to have your questions answered via voice. A recorder will take your message. end goto -scroll -line303 call -header | begtype You can access the bulletin board service by using any 300 baud or 1200 baud modem with your computer. You can use 8,N,1 or 7,E,1 protocols. You will also need a communication program such as PC-TALK III, CROSSTALK, QMODEM, or SmartCom. Contact your local computer store if you need more information or help with communication equipment or software. Service is available 24 Hours a day. Your personal password will be supplied when you register. end goto -scroll -line399 %i = 304 -line304 call -header | begtype To access BAT-BBS by modem: 1. Call the BAT-BBS phone number and wait about two rings then hang up. 2. Call the BAT-BBS again, it will immediately answer the phone and wait for the carrier from your modem. The BAT-BBS is a "ring-back" system. To access BAT-BBS by voice: 1. Call the BAT-BBS phone number and wait about four rings. A recorder will take your question on the forth ring. 2. You can take your time. The recorder will continue as long as you are talking. Be sure to leave your NAME and ADDRESS for a response. The BAT-BBS phone number is 305/276-5072. end goto -scroll -opt4 -line305 %i = 400 -line400 %H = Introduction | call -header | begtype BAT is short for Extended Batch Language. BAT is a powerful productivity tool for the IBM Personal Computer. It represents a significant advance in providing a comprehensive yet easy to learn and use facility for controlling tasks you give your computer. It can even give you on-line documentation SUCH AS THIS! BAT is a command programming language. It is a high level language that can be used as a direct replacement or in conjunction with DOS batch files. It can operate with IBM DOS versions 2.0 through 3.x. Compared with standard DOS batch files, BAT has superior control structures, string handling, and user interfaces. It also has tracing facilities, and is easy to learn and use. Many aspects of the language are like BASIC. Users of VM/370 will also find it similar to EXEC2. It seems that both "end users" and programmers find BAT a simple and effective language. end goto -scroll -line401 call -header | begtype With Extended Batch Language, you can have: - Better control of messages to the screen - Accept responses from the user and create responses to programs - String handling operations (substring, length, etc.) - Arithmetic expressions and assignments - Comparisons and program return codes - Search for files or tell if they exist - Complete freedom to mix DOS and BAT commands within the same control file Let's look at how it measures up to today's DOS...... end goto -scroll -line402 call -header | begtype Function DOS 1.1 DOS 2.0 or 3.0 Extended Batch Lang. ---------- ------- -------------- -------------------- BEEP X CALL/RTN X CLS X X BEGSTACK X BEGTYPE X EXIT X X GOTO X X IF Limited X INKEY X READ X READSCRN X SKIP X STATEOF Limited X STACK X TYPE Limited X X Assignments X TRACE X DOS Vars X X X Global Vars X Return Codes X X end goto -scroll -line403 call -header | begtype As you can see from the previous chart, Extended Batch Language has more power and enhanced capabilities than any version of DOS!. This program uses these capabilities to solve common problems for...... The system programmer - who needs to do long sequences of tasks between linker, compilers, debuggers, and editors. He can now create an intelligent link between these programs. For instance, he may wish to do a link depending on if the previous compile was successful. He can also respond automatically from a keyboard "stack" into various utilities. The secretary - who has several types of tasks to perform (word processing, accounting packages, etc) and requires a simple way of changing from one type of task to another, perhaps with optional help text. The student - who wishes to go from one game to another without having to learn the system commands required to make each available. Testers - who wish to automate long, boring tests and procedures on the personal computer. An excellent tool for a manufacturing line. end goto -scroll -line499 %i = 404 -line404 call -header | begtype The effect of using BAT is to put "covers" on the programs and system that it controls. In UNIX they call it shells, in VM they call it EXECs, but to you it simply makes things friendly. Described in these pages is a solution to batch files through the use of Extended Batch Language. A friendly interface to you can now be easily created. Once you have looked over the descriptions of each command, browse through the BATDEMO.BAT file and look at the commands in operation. By trying out some sample programs, you should be able to gain a full understand of how to write some powerful batch files by using Extended Batch Language. Copyright (c) 1982, 1983, 1984, 1986 by Seaware Corp. Program by All Rights reserved by Seaware Corp. Frank Canova end goto -scroll -opt5 -line405 %i = 500 -line500 %H = "Version 3: The inside story!" | call -header| begtype We threw the book at it! Almost everything you could possible have is now in Extended Batch Language Version 3. We took time in getting everyone's suggestions into it, and used very little memory in doing it. Here's some of the highlights: * Menus are easy to create. Just use the "Executive Menu Facility" to create customized menus the way YOU want to see them. This automatic procedure, written in EBL, will create a custom menu without ever having to know any details about the EBL Language or batch files. Using your PC couldn't be easier. * Complete freedom with all variables. Strings can be up to 127 characters mixed case, numbers to 19 digits. If the built in variables aren't enough for you, you can now have as many as you want! Reserve from 0 to 64K of memory for "extended variables" that can have long descriptive names, do indexing, create arrays, and more. For floating point arithmetic? Just load the optional float point math extensions! end goto -scroll -line501 call -header | begtype * Extended functions give you additional power where you need it. Intended for programmers needing special capabilities, several types of functions are available: DOS support (CHDIR, MKDIR, REBOOT), low level system support (PEEK, POKE, INT86), string support (STRIP, LOWER, UPPER), math support (FLOAT, INT, FRAC), and MUCH more! * Add your own functions to EBL. If you have additional requirements for the EBL language, you can create them using MASM, C, Pascal, etc. The source code for Seaware's extended functions (written in Turbo Pascal) is provided as an example to registered users. * Full support for many more environments like PC Network, TopView, Windows, DESQview and of course DOS 2 and DOS3. Also, a flexible interrupt mechanism was added that makes EBL work with even more programs than ever before. end goto -scroll -line599 %i = 502 -line502 call -header | begtype * File I/O is easy within EBL Version 3. Use it to setup printers, keep configuration information, initialize programs, or even create other batch files! * Error recovery is now available within batch files! In cases where an error is detected while the EBL batch file is running, you can now include a routine to recover gracefully from the problem. end goto -scroll -on.error- %e = %e + 1 | if %e > 2 then %L = ? | skip 4 if %R <> 6 then skip 3 %G = .goto. color 8f | type Loading part 2 ... batdoc2 begtype Unexpected error \%R in line \%L ! This batch file was error free when it was distributed by Seaware. An error indicates that it was most likely modified by someone improperly. To get an updated demo diskette send $10 to Seaware directly or call 800/622-4070 or 800/942-7317 in Illinois. Seaware Corp. Post Office Box 1656 Delray Beach, FL 33444 end %G = %E = 0 exit